home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / conv / iff2asci.lha / IFFtoASCII.Doc < prev    next >
Text File  |  1991-12-31  |  5KB  |  121 lines
  1. IFFtoASCII
  2. (C) June 1992 Paul Huxham
  3. Organization: WaveFrame, Perth, Western Australia
  4.  
  5. Written in AMOS V1.34
  6.  
  7. This program is freely redistributable.
  8. Any copyright however remains with the author.
  9.  
  10.  
  11. WHAT IT DOES
  12. ============
  13.  
  14.   IFFtoASCII is designed to convert 16 Grey Level IFF pictures into lines
  15. of ASCII characters that when viewed from a distance look like the original
  16. picture.
  17.  
  18.  
  19. HOW TO DO IT
  20. ============
  21.  
  22.   When loaded, click to enter the conversion routines. Select the image to
  23. convert (right mouse button shows devices and assignments). Images that are
  24. colour, HAM or brushes (images not full screen height and width in their
  25. respective resolutions) should not be loaded. They will give unpredictable
  26. results.
  27.  
  28.   IFFtoASCII shows you the screen width, height and number of colours of
  29. the loaded image.
  30.  
  31.   Select whether you would like the image converted in PORTRAIT or
  32. LANDSCAPE mode.
  33.  
  34.   Next select FULL SCREEN or DRAW RECTANGLE. DRAW RECTANGLE allows you to
  35. define an area of the image to convert. Click the LEFT mouse button to
  36. start drawing a box, and press the LEFT mouse button again to finish
  37. drawing. You may now either click the LEFT mouse button to start drawing
  38. another rectangle (losing the first), or the RIGHT mouse button to accept
  39. the currently drawn rectangle and continue.
  40.  
  41.   Now enter the HORIZONTAL PIXEL TO TEXT RATIO and the VERTICAL PIXEL TO
  42. TEXT RATIO. These can be a little confusing at first. Pressing return at
  43. each prompt will load the default for an 80x24 text screen. Basically the
  44. value entered is how many pixels represent 1 ASCII character. Be careful
  45. when converting LORES INTERLACED pictures because the aspect ratio
  46. vertically is twice the ratio horizontally (For 80x25 text output). It is a
  47. good idea to experiment a lot with these settings to obtain the best
  48. results. For example:
  49.  
  50.    Source Picture    Horizontal    Vertical   ASCII (Correct aspect)
  51.       320x200            2            4       160x64
  52.       320x400            2            8       160x64
  53.       640x200            4            4       160x64
  54.       640x400            4            8       160x64
  55.  
  56.   Next enter the number of grey levels to be represented in ASCII. Possible
  57. values are 1, 2, 3, 4, 5, 6, 7, 8, 16. For example:
  58.  
  59.     1  is Black or White  (2 different ASCII characters)
  60.     16 is Grey            (16 different ASCII characters)
  61.  
  62.   Select an output file. A default name is given containing the horizontal
  63. aspect, vertical aspect and number of grey levels. Useful for default names
  64. to see which one looks the best. Files ARE NOT OVERWRITTEN. You will be
  65. asked to confirm the overwrite if the output file already exists.
  66.  
  67.   The image will be converted. Click on CANCEL to abort the conversion.
  68.  
  69.   You will then be asked if you wish to convert more images or to quit.
  70.  
  71.   When you print your pictures, try setting condensed mode on your printer
  72. (dont forget you then have to chnage the aspect ratio to get twice as many
  73. characters horizontally than normal!). Or even condensed and half height
  74. (no aspect changes required). The pictures look suprisingly good. (Well
  75. what can you expect from ASCII characters :-)
  76.  
  77.   Seven example files of various sizes (you might have to load an editor
  78. that supports files wider than 80 columns to see some of them) are included
  79. so you can see what to expect (dont get your hopes up to high though :-).
  80. All but one are included twice, once in 8 grey levels and once in 16 grey
  81. levels and in portrait mode. The remaining picture is in landscape mode.
  82.  
  83.  
  84. WHAT WILL HAPPEN NEXT
  85. =====================
  86.  
  87. Not in any order:
  88.  
  89. i)    Yeah I know the interface is the pits, but its how it is.
  90. ii)   Need to able to enter a figure for the number of columns and rows
  91.       versus the current aspect ratio system.
  92. iii)  Support for colour and HAM pictures.
  93. iv)   Support for pictures larger than the screen.
  94. v)    Presets for aspect ratios and grey levels. eg Lores-Interlaced.
  95. vi)   Be able to move the rectangle in DRAW RECTANGLE once drawn to the
  96.       right size.
  97. vii)  Rewrite in C. Yeah I know its slow, especially on 68000.
  98. viii) User defined ASCII characters for grey levels.
  99. ix)   Preferences file.
  100. x)    Moveable information screen using RIGHT mouse button.
  101.  
  102.  
  103. IF YOU'RE NOT HAPPY
  104. ===================
  105.  
  106. In BLACK or WHITE:
  107.  
  108. i)    Don't use it and write your own.
  109. ii)   Suggest changes to IFFtoASCII.
  110.  
  111.  
  112. FOR MORE INFORMATION
  113. ====================
  114.  
  115.     Paul Huxham
  116.     PO BOX 875
  117.     Morley, Perth
  118.     Western Australia 6062
  119.  
  120.     or via email:   paulh@wavefrm.DIALix.oz.au
  121.